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TRS-80 BASIC PROGRAM UTILITY 

COMMAND PROCESSOR 

"COMPROC" 

INTRODUCTION 

COMPRCC is a simple and easy to use system which enables the user 
to automatically execute a series of TRS-80 DOS system or BASIC 
commands. This provides the user with a convenient method for per- 
forming repetitive operations. Following are some of the key fea- 
tures of COMPROC: 

t Command files may be created containing any logical sequence 
of system ccmr.and5, BASIC statements, or data. 

• Command files rr.ay be selectively executed, Including Initia- 
tion by th: AUTO coanand at power-up time. 

t Creation, saving, and editing of any command file may be 

easily accomplished using standard NEW, SAVE, and EDIT opera- 
tions of BASIC. 

I Up to nine fields may be specified at execution time to be 

Inserted at specified locations 1n the users command sequence. 

• COMPROC will prompt the user for missing Information at 
execution time, allowing the user to respond according to 

current requ1rer%ents . 

• Loading and relocating of the keyboard debounce routine may 
be optionally specified. 

• COMPROC will run Iri any size TRS-BO DOS system and is auto- 
matically relocated so as not to conflict with other BASIC 
or machine language programs. 

These, and many othar features of COMPROC allow the user to create 
procedures that non-computer oriented personnel can easily use. 

METHOD OF OPERATION 

The following general steps are performed when using the COMPROC 
system: 

i The user creates a co^and flle(CMF) containing the list 
of conrjnds or data to be processed. A very simple CMF Is 
shewn in Flnure(l). Note that this Is a standard BASIC 
file containing REM state~ents( the ' Is an abbreviation 
for REM), 

t The user In'tlates COMPROC by entering a standard DOS com- 
rrand as shewn 1n the example. 

• CGMPPOC scans the CMF, extracts Inforration, and Inserts 
optional fields to form a compressed control program. 

• The compressed control program Is relocated to a temporarily 
reserved an?s and passes the desired infomatton to the 
system as If the user had entered It from the keyboard. 

» After oil statements have been processed COMPROC will 
release any -eserved area and return control to the key- 
board. 



User Command 



com ;- proc* *AYeoXt< 



Command File 



100 
105 
110 
115 
120 



'VERIFY(ON) 
'BASIC 



'Rutf "i\r 




Command Execution 



VERIFY(ON) 

DOS READY 

BASIC 

NUMBER OF FILES* 

MEMORY SIZE? 

READY 

RUN "WftROLl" 



Figured). Simple COHPROC Example. 

Note that <n the above example the user command could be let 
with the AUTO command as follows: 

AUTO COM PROC PAYROLL 

This would execute the above CMF script at power-Up time without 
any other user action required. 

LOADING COMPROC TO DISK 

COMPROC Is distributed on cassette tape which must first be 
loaded to disk prior to use. The recommended procedure Is as 
follows (user Input Is shown underlined ): 



1. 
2. 

3. 

4. 
5. 
6. 
7. 
8. 
9. 
10. 



Bring \n TRSMS 

BASIC 

RDTTfANY FILES? 

MFMORY SIZE? " 

CM0"T" 

STSTTH 

TCOM 

?BT 

CHD"S 



(user enters BASIC command) 

(must turn off clock!) 
(executes SYSTEM command) 
( COHPROC name-COM) 
fc« break keyf~ 
(go bdck to DOS) 



TJORTTOM/CMD (START'X' 7000' ,ENP»X' 7700', TRA'X' 7000') 



The above procedure will load COMPROC Into a file named COM/CMD, 

although any other file hams could be used. 

EXECUTING COMPROC 

COMPROC 1s a machine language program which 1i executed In DOS 
command mode. The general format of the User command statement 1$ 
shown belowfassumlng COM/CMD 1s used as the program file name): 

COM fllespec(lnf) pantill parol? ... parmln 

where 

fllespec The name of the command flle(CMF) containing the users 
script to. be executed. The file extension na.me will 
default to /CMF If not otherwise specified. 



M n j) optional specification Immediately following and 

enclosed within parenthesis Indicating the lowest line 
number in the CMF to be processed. The first line In 
the CMF will be used If (1n«) 1s not present. 

parmll Optional parameter fields which are to be Inserted at 

parm*2 specified locations In the users CMF. Each field must 

; be separated by one or more blanks and contain no 

• ,. blanks within the parml field, 
parmln 

Trailing fields may be left unspecified on the COM command state- 
ment. The COMPROC analysis program will prompt the user for any 
mUsIng fields at execution time. This allow* the user to Inter- 
actively supply parameters based upon current requirements. 

COMMAND FILE DESCRIPTION 

A. General Format 

The CHF Is a BASIC program file containing a sequence of REM and 
END lines. The Information used by COMPROC follows Immediately 
after each REM(or Its abbreviation "'"). Trilling blanks are removed 
and replced by one carriage return(ENTER-key)- character. The user 
must anticipate all responses needed to accomplish a given task and 
Include the appropriate lines In the CMF script.' 

Several scripts may be placed 1n the same CMF. Each scr1pt(except 
the last) must be terminated with an END. line or a 7X7 function code. 
COMPROC will process all lines greater than or equal to the (lnl) 
option up to the cnd-of-scr1pt or end-of-fllei Whichever comes first. 

B. Parameter Fields 

Optional parameter fields may be specified on the COM user command 
as discussed previously. These fields will be Inserted In the users 
script at locations Identified by the sequence! 

7n? 

where "n" 1l th« relative parameter field number(l,Z, ... n). Each 

occurrence of the 7n7 sequence In the CMF Is replaced by the corres- 
ponding parameter field from the COM user ccrmand. 

C. Function Codes. 

The user ray place special function codes In the CMF to perform 
a number of actions^ The function code Is specified by the sequence! 

where "f" Is a one letter* code summarized In F1gure(2), 

0. Memory Size Specification 

The corpressed COMPROC control program produced from the users 
CMF Is relocated to a temporarily reserved ai«a Just below the 
highest value available to DOS or BASIC; This 1s specified by: 

1. The first line In the script containing the momory sl/e. 
This Una 1) Uirn deleted from the Script to bo mteculud. 

2. The memory size entered In the normal sequence In the script 
when Initiating BASIC. 

3. The highest memory location If neither* of the above Is given. 

4. The lowest value If specified more than once. 



Code Description 



?B? 
?C? 

?D? 
71? 



7L7 
?P? 

?R? 

7U7 
?X? 



Break-key - This enters a break key character In the script. 
Thl s can be Used, for example, to terminate an AUTO command. 

Clear-key - This enters a clear-key character 1n the script. 
This performs the sane action as If the user had pressed 
the clear key at that point. 

Down Arrow-key - This enters a down arrow-key{ 4 ) character 
in the users script. 

Interactive Input. - This specifies that COMPROC Is to revert 
temporarily to the keyboard for data Input. This mode will 
be terminated when the user presses the carriage return 
(ENTER-key). The carriage return character 1s not passed 
ort to the system. After the users carriage return COHPROC 
will continue processing any remaining script. 

Left Arrow-key - This enters a left arrow{ *- ) backspace 
key character 1n the users script. 

Pause - This enters a pause code Into the OIF. COMPROC 
will temporarily suspend processing until the user presses 
any key(s1m1lar to the shift 9 key 1n BASIC). 

Right Arrow- key - This enters a right arrow( -* ) tab key 
character In the users script. 

Up Arrow- key - This enters an up arrow-key( t ) character 
In the users script. 

Exit - This terminates the current script similar to an 
END line except no trailing carriage return Is generated. 
This allows the user to continue the last command on the 
same I1ne(e.g. RUN "7X7"). 



F1gure(2). Function Code Sun-nary 

COHPROC will subtract the amount of memory required for the com- 
pressed control program from the memory size as determined above. 
This extra space will then be released by COMPROC when the last line 
of the users script has been executed. This space will be added to 
the users string space If BASIC 1s 1n control. 

E. key Debounce Roftlne Specification 

An optional routine Is available In COMPROC that will help reduce 
the double striking or "key-bounce" problem on the TRS-BO. This 
routine will be loaded Into memory by specifying: 

'DEBOUNCE or REMDEBOUNCE 

1n the first line of the script, or the! second line If a memory slie 
1s specified on the first 11ne(See D.l above). This routine will 
be relocated just below the memory size value determined 1n 0,1-0.4 
ahovf. 

If 'ULUOUSCE Is not sped fled then any existing keyboard debounce 
routine Is deactivated. 



DETAILED EXAMPLE 

F1gure(3) Illustrates a more complex use of COMPROC. Shown at 
the top Is the user command, associated prompting messages, and 
user Input responses. On the left 1s the CMF containing the state- 
ments to be processed by COMPROC. The resulting command execution 
sequence Is shown on the right. User Input 1s shown underlined , and 
shaded areas represent parameter fields and function codes. 

Summarized below 1s an explanation of the feature* demonstrated 
by this example. 

1. The user Initiated COMPROC by entering only "COM". COMPROC then 
prompted the user for the missing CMF procedure fllespec and 
other fields needed. The user could have provided all Informa- 
tion on the Initial command line, 1e 

COM PR0C(200) PAYR01L/8AS GSF 

2. The Of shown contains two scripts. Line #140 Indicates the 
"END" of the first script. The second script continues through 
Line #400. Note that Line #340 1s not an END statement for the 
second script since It contains a liad"1ng REM('). 

3. The user specified PR0C(200) Indicating that processing should 
start at Line #200 In file PROC/CMF. 

4. Lines #200 & #280 both Indicate memory size to be reserved for 
user protected area. The smaller value(62168) 1s further reduced 
by a snail amount for COMPROC and the DEBOUNCE routine. This 
value(61822) replaces the corresponding value at Line #280. 

5. Line #210 specifies that the keyboard "DEBOUNCE" routine 1s to 
be loaded and relocated(Just below 62168 In this case). Note 
that Lines #200-210 are eliminated from the script. 

6. Lines #250 * #290 show the use of parameter fields. In this 
case 71? Is replaced by PAYROLL/BAS and 72? by GSF from the 
user command prompt responses. 

7. Lines #230, #240, & #360 Illustrate the use of the Interactive 
function code 717. Upon encountering this function code CS1PR0C 
temporarily activates the keyboard to allow the user to continue 
the sequence. In this case the user enters the time, date, and 
line I to be "RUN". COMPROC continues with the remaining script 
after the user presses the ENTER-key. 

8. Line #350 contains a break-key function code. This 1s required 
to terminate the AUTO mode active 1n Lines #300-340. 

9. Line #320 shows the use of the right arrow(->-) function code 
7R7. This Inserts a tab 1n the resulting S.rlpt. 

10. Line #360 specifies a pause function code ???. The system 
pauses at this point until the user presses any key. 

11. Lines #370-380 Illustrate that the users script can also contain 
data. 

12. Line 1400 shows the use of the terminate function code 7X7. This 
Is an alternate method of terminating the script which results In 
no trailing carriage return(ENTER-key) . This allows the user to 
complete the last line from the keyboard. In this e*a-.ple 
another COM command Is entered which executes the first script In 
the CMF at Lines #100-140. 

-5- 



HINTS AND SUGGESTIONS 

The user should read very carefully the following hints and 
Suggestions 1n order to effectively utilize COHPROC. 

1. User written machine language program tnay bypass COHPROC When 
calling the system keyboard routine for data. COHPROC only 
Intercepts calls to 0049H and 0384M(or routines that call these 
addresses). Any calls to 002BH as documented 1n the TRS-EO 
Editor Assembler Manual will bypass COMPROC and expect data to 
be entered directly from the keyboard. 

2. While COHPROC 1s 1n control all keyboard keys ara Inactive except 
the Break-key. This may be used to terminate COHPROC wh<>n 1t 

Is In control. 

3. User program that utilize maximum memory may return an "CUT OF 
MEMORY" message when using COWAOC. This 1s due to the snail 
amount of extra space required by COHPROC. This can usually 

be avoided by only using COHPROC to Issue the RUN statement for 
the large program. This will release space occupied by COMPROC 
Just prior to the start of execution. 

4. The COM user ccrnand nay be Initiated by the AUTO feature. Refer 
to tha MS Users Manual for details on the use of the AUTO command. 
Also see the example associated with Flgure(l) on Page(Z). 

5. The last line of the users script may contain another COM user 
Corrjnd. This provides a method of Unking from one script to 
another. The system must be in DOS mode when this statement is 
finally executed. The COM comnand may cot appear anywhere else 
in the users script. 

6. Any user co^nand sequence which would allow the debounce routine 
to be destroyed, such as a change in merory size not under the 
control Of COMPROC, iwy cause unpredktlble results. The user 
cm deactivate the debounce routine by executing COHPROC with 

no KBOUNCI itite-ient. 

7. Loading i machine language program twy destroy COMPROC, DEBOUNCE 
routine, or Other systen data If an Inadequate memory size 
paranater 1s specified. The user Is responsible for tha correct 
use of protected menory. 

8. COMPROC cannot anticipate or detect system or user application 
errors. As a result the script may becoiie unsynchronlzed causing 
Incorrect results. For example, 1f a "PROGRAM NOT FOUND" error 
message results from a LOAD operation the following commands, such 
as a RUN statement, will probably fall. The user should try to 
keep scripts small and uncomplicated. fcr example, the script 
shown in F1gure(3) Is unnecessarily complicated for most practical 
for most practical Uses. 



Ubct Corrcnand 



COM .,-"• ■■-*-'-■ -->•*.•*"•..•; 

ENTER CMF PROCEDURE 'FILESPEC?Pi lOC?2Q0) 
ENTER PARAMETER FIELD fll7PAY kOLUF-*'o 
ENTER PARAMETER' FIELD f2?UJ3£. ; 



Command File: ¥R0'C/CRF 



ICO 


'BASIC y 


110 


1 / 


120 


' / „ 1 


130 


'RUN "PAV/BA3" 






200 


'62168 


210 


'DEHOUN.CE. 


220 


'VERIFY (ON) 


230 


'TIME fit 


240 


'DATE IV. 


250 


'LOAD t ?7 /OBJ 


260 


'BASIC 


270 


'4 


.290. 


'62719 


290 


'LOAD r 'Ul" 


300 


•auto iooo 


310 


'FOR 1-1 TO 2 


320 


'.7R7INPUT J:7J+13 


330 


'NEXT 


JA.g 


lEN.D 


350 


' 7B7SAVE "PAY/BAS" 


'36 0' 


MrtRUN :nf 


370 


'153 


.MR:. 


'192 


390 


'CMD "s" t 


400 


r COM ?X? 



Corannd Execution 



,0' 


DOS READY \ 1 


.t- 


VERIFY (ON) M 




DOS READY !| 




TIME 17:58; 13 ; 




DOS READY ; I 




DATE 04/22/79 ;, 




DOS READY "1 




LOAD C»f/OBJ 


■.. 


DOS READY j 




BaSTC ' 




HOW MANY FILES7 4 




MEMORY SIZE - ? 61S22 


4 


RADIO SHACK DISK BAStC... 




BEAPV . ; 


*, 


LOAD 'TAYROLL/EAS'" 


\ 


READY 




■AUTO IOOO 




1000 FOR 1=1 TO 2 




1010 • '- i'' .'INPUT J:?J + 13 




1020 NEXT 


• 


1030 END 




1040 


• * 




\ 


SAVE ''PAY/BAS' 1 


^ 


.REAPX, 




■RUN iOOO 


• 


7 153 


.'* 


166 


\\ 


7 192 


» « 


203 




READY 




CMD 3" 


1 


DOS READY 


1 


COM fcgflfl 


\ 


BASIC 


■ 
1 


HOW MANY FILF.S7 


» 


MEMORY SIZE? 6 5 397 


« 


RADIO SHACK DISK BASIC... 


', 


READY 




...wnLiifAY/BA?:: ■ 




I (under User control ) 



F1gure(3). Complex COMPROC Example. 



i |- RACET couwm -^ . «r jW 

"" tit NlaOU. C«u|l U litis 

COMPPOC Version 1.? Ad4enda 

CC.MP30C Version 1.2 added ft* turn not found on Version 1.1 is follows: 

1. C0.mpf.0C now works with the Apparat firwnos. To use with KOTOS, the first 
line of the Corrcand File (CXF) nust specify APPARAT. e.g. 

10 'APPARAT 

2. Lower case driver object code has been added to Version 1.2. To request lower 
case, on the first line of the Coirtund File, include the words LOWERCASE 
Fimples include: 

10 'APPAJIAT. LOWERCASE 

Oil 

10 , 6213;,DEB0imCE. LOWERCASE 

^optional do not use with Apparat NEWnOS 

Note: Lower case hardware modification must be Installed for the 
lower case code to function properly. 

3. A screen print co-r>and has been added to CPHPROC for use when using TT.srOS. 
To use the screen print comond, specify REBOIWCI on the first line of We 
Coc=and file. When it Is desired to print the screen contents, sinult;n- 
(ously press the SHIFT, down arrow, and P keys. This feature (JKL) keys 
tlur.g with a UiTiiH denounce routine are Incorporated in the Apoerat 
KEI.DOS, and, therefore are not Included In Version 1.2 of cnvPROC. 

When loading COMPP.PC to disk (Ref. pg 2 of annual), end dunp at 7900 hex, 
l.l. line 10 should read: 

10. NJHP COM/CKO (STAI^T■X•7C0O•,EN0-X , 790O , ,TRA■X'700O•) 



